home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / nsc123f.zip / NSC-F.DOC < prev    next >
Text File  |  1993-04-13  |  17KB  |  464 lines
  1.  
  2.                             Node Speed Checker v1.23
  3.                    Une application de vérification de vitesse
  4.                             Copyright (C) Avril 1993
  5.                               Par Claude Champagne
  6.                                    C.P. 1312
  7.                              Trois-Rivières,Québec
  8.                                     G9A-5L2
  9.  
  10.  
  11.  
  12.    L'auteur de ce programme ne peut être tenu responsable pour quelque
  13.    dommage  que  ce  soit, réel  ou  autre  causé  par  ce  programme.
  14.    Tout usage de ce programme signifie que vous comprenez cet avertissement.
  15.  
  16.    REMERCIEMENT:
  17.    Je remerci Mr. Richard Cawley (Amawalk Premium PCBoard 914-245-5656) de
  18.    son support technique ainsi que de l'aide apporté pour l'anglicisation de
  19.    la documentation anglaise.
  20.  
  21.  
  22.  
  23.                                     INDEX
  24.  
  25.  
  26.  
  27.    Liste des fichiers contenu dans NSC123F.ZIP . . . . . . . . . . . . .2
  28.  
  29.    INTRODUCTION  . . . . . . . . . . . . . . . . . . . . . . . . . . . .2
  30.  
  31.    Ce que fait l'application NSC-F . . . . . . . . . . . . . . . . . . .3
  32.  
  33.    Du nouveau dans la version 1.23 . . . . . . . . . . . . . . . . . . .3
  34.  
  35.    REQUIEREMENTS . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
  36.  
  37.    CONFIGURATION . . . . . . . . . . . . . . . . . . . . . . . . . . . .4
  38.  
  39.    Format du fichier de configuration  . . . . . . . . . . . . . . . . .5
  40.  
  41.    Signification de chaque ligne du fichier de configuration   . . . . .5
  42.  
  43.    - Explication des lignes 1 à 2  . . . . . . . . . . . . . . . . . . .5
  44.    - Explication des lignes 3 à 6  . . . . . . . . . . . . . . . . . . .6
  45.    - Explication des lignes 7 à 12 . . . . . . . . . . . . . . . . . . .7
  46.    - Explication des lignes 13 à 14  . . . . . . . . . . . . . . . . . .8
  47.  
  48.    NOTE  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8
  49.  
  50.    COPYRIGHTS  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8
  51.  
  52.  
  53.                                      Page 1
  54.    NODE SPEED CHECKER v1.23                      Page 2
  55.  
  56.  
  57.  
  58.    Liste des fichiers contenu dans le ZIP:
  59.    ───────────────────────────────────────
  60.  
  61.    FILE_ID  DIZ       425 04-13-93  Courte description.
  62.    NSC-F    DOC     16553 04-13-93  ...
  63.    NSC-F    EXE     36199 04-13-93  Exécutable.
  64.    NSC-1    CNF       156 04-13-93  Configuration.
  65.    LUCKYS   DAT        28 04-13-93  Usagers qui n'ont pas à être vérifier.
  66.    EXPLIQUE TXT       350 04-13-93  Explications lors d'un rejet.
  67.    REGISTER FRM      2328 04-13-93  Enregistrement de Node Speed Checker.
  68.  
  69.  
  70.    Les données de validation de NSC-F.EXE sont:
  71.  
  72.    VALIDATE 0.4 Copyright 1988-92 by McAfee Associates.  (408) 988-3832
  73.  
  74.           File Name:  nsc-f.exe
  75.                Size:  36,199
  76.                Date:  4-13-1993
  77. File Authentication:
  78.      Check Method 1 - 3A6C
  79.      Check Method 2 - 0022
  80.  
  81.  
  82.    INTRODUCTION:
  83.    ─────────────
  84.  
  85.    Vous avez une node HAUTE-VITESSE ou corrigeant les erreurs?
  86.    Vous aimeriez  la  réservée aux  usagers possédant un modem
  87.    HAUTE-VITESSE ou corrigeant les erreurs?
  88.  
  89.    Vous voyez que certains usagers appellent en premier lieu sur votre
  90.    node HAUTE-VITESSE  à  des vitesses  de  1200 ou 2400 bauds et sans
  91.    correction d'erreurs quand il  y  a d'autres nodes qui sont libres?
  92.  
  93.    Vous aimeriez peut-être réservé une node ou plus à un nombre
  94.    restreint d'usagers 'sélect'  et  rejeté les  autres appels?
  95.  
  96.    Voici la solution à vos maux et celui de vos usagers 'privilégiés' qui
  97.    possèdent  un  modem HAUTE-VITESSE ou  modem avec correction d'erreur!
  98.  
  99.  
  100.                                      Page 2
  101.    NODE SPEED CHECKER v1.23                      Page 3
  102.  
  103.  
  104.  
  105.    Ce que fait l'application NODE-SPC
  106.    ──────────────────────────────────
  107.  
  108.    Cette application vérifie l'usager de la node HAUTE-VITESSE
  109.    comme suit:
  110.  
  111.    - Vérification des noms contenus dans la liste LUCKYS.DAT.
  112.      Si son nom y est inscrit, retour au BBS.
  113.  
  114.    - Comparaison de la vitesse de connection de l'usager avec la
  115.      vitesse minimale d'accès.
  116.      Si la vitesse de connection est égale ou supérieure, retour au BBS.
  117.      Sinon, vérification du nombre de node(s) libre(s).
  118.      S'il n'y  a  pas de nodes de libre, retour au BBS.
  119.  
  120.      Par contre, s'il y a au moins X node(s) de libre, l'usager reçoit le
  121.      contenu  du  fichier EXPLIQUE.TXT  et un apperçu de l'état des nodes
  122.      (WHO). Après l'envoi du 'WHO', l'application coupe la communication
  123.      et termine avec un ERRORLEVEL de 1.
  124.  
  125.    IMPORTANT:
  126.     ┌────────────────────────────────────────────────────────────────────┐
  127.     │ Le temps entre la vérification et le retour au babillard peut être │
  128.     │     diminué considérablement en faisant un SHELL à la DOOR.        │
  129.     │                                                                    │
  130.     └────────────────────────────────────────────────────────────────────┘
  131.  
  132.  
  133.    Du nouveau dans la version 1.23
  134.    ───────────────────────────────
  135.  
  136.    - Corrigé un autre bug sur la lecture de USERNET.XXX (v1.23)
  137.      Ne fonctionnait qu'avec la version /E100. Car l'entête est
  138.      différente d'une version à l'autre (/E2 à /E250). Tests de
  139.      lecture effectué sur /E2 à /E250 avec succès.
  140.  
  141.    - Corrigé un bug sur la lecture de USERNET.XXX (v1.21)  
  142.  
  143.    Supporte IRQ et ports de communication non-standard
  144.    Vitesse maximale de 57600 bps
  145.    Supporte PCBoard v14.5a (USERNET.XXX au lieu du USERNET.DAT)
  146.    Support des versions PCBoard /E3 à /E250
  147.    Support d'une liste d'usagers à ne pas vérifier
  148.    Génération d'un fichier LOG
  149.    Tient compte des nodes qui sont, elles aussi, vérifiées par NSC-F.EXE
  150.    
  151.    Lorsque la communication est coupée, le programme termine en retournant
  152.    un ERRORLEVEL  de 1 au DOS. Ce  qui pourra servir dans un fichier batch
  153.    pour  éviter  l'exécution  d'un  utilitaire  ou  autres.
  154.  
  155.  
  156.  
  157.    REQUIEREMENTS:
  158.    ──────────────
  159.  
  160.    PC compatible (80286+), PCBoard v14.5a /E3 à /E250,
  161.    55 Kbytes RAM approx., les fichiers: 
  162.                                         PCBoard.sys
  163.                                         Luckys.dat
  164.                                         UserNet.xxx
  165.                                         Explique.txt
  166.                                         NSC-1.cnf
  167.  
  168.  
  169.                                      Page 3
  170.    NODE SPEED CHECKER v1.23                      Page 4
  171.  
  172.  
  173.  
  174.    CONFIGURATION:
  175.    ──────────────
  176.  
  177.    Vous  pouvez  exécuter  NSC-F.EXE  sans  paramètre  pour avoir
  178.    un apperçu de la synthaxe du programme et du format du fichier
  179.    de configuration.
  180.  
  181.    Avant de démarrer l'application, veuillez créer  un fichier de
  182.    configuration sous  un nom quelconque (Ex: NSC-1.CNF). Le  nom
  183.    du  fichier  devra  être  passé  comme  paramètre  au  fichier
  184.    EXEcutable (NSC-F.EXE) comme suit:
  185.  
  186.    NSC-F NSC-1.CNF
  187.  
  188.    Notez bien qu'un fichier de configuration sert pour une node, s'il
  189.    le faut, créez un deuxième fichier de configuration dans le cas où
  190.    vous auriez  une  2ième node  à  faire vérifiée  et ainsi de suite.
  191.  
  192.    La configuration et la signification de chaque ligne du fichier est
  193.    expliquée à la Page 4.
  194.  
  195.    Il y a 2 façon d'installer l'application:
  196.  
  197.    1-. La  plus  simple est  de  faire démarrer celle-ci tout de suite
  198.        après l'entrée du mot de passe en passant par le fichier batch:
  199.        $$LOGON.BAT, vous n'aurez qu'à inscrire la commande:
  200.        NSC-F NSC-1.CNF
  201.        par exemple à l'intérieur de ce fichier.
  202.  
  203.        Un fichier $$LOGON.BAT est requis pour chacune des nodes  à  être
  204.        vérifiée (Ex: C:\PCB\$$LOGON.BAT, C:\PCB3\$$LOGON.BAT qui vérifie
  205.        les nodes 1 et 3 dans cet exemple).
  206.        Fichier --> $$LOGON.BAT
  207.        @echo off
  208.        NSC-F NSC-1.CNF
  209.        IF ERRORLEVEL 1 IF NOT ERRORLEVEL 2 GOTO FIN
  210.        prog1
  211.        prog2...
  212.        :FIN
  213.  
  214.    2-. Autre méthode, plus longue cette fois-ci,  et requiert l'édition du
  215.        fichier DOORS.LST pour chaque nodes à être vérifiées, de même qu'un
  216.        fichier  batch  pour  chacune  des  nodes  à  être  vérifiée.
  217.        (Ex: Fichier --> NSC1
  218.        @echo off
  219.        D:\PCB\NSC-F NSC-1.CNF
  220.        BOARD
  221.        )
  222.  
  223.  
  224.                                      Page 4
  225.    NODE SPEED CHECKER v1.23                      Page 5
  226.  
  227.  
  228.  
  229.    Format du fichier de configuration (Ex: NSC-1.CNF)
  230.    ─────────────────────────────────────────────────────
  231.  
  232.    Nom du BBS                      ;Nom du Babillard
  233.    0                               ;Numéro d'enregistrement
  234.    1                               ;Numéro de la node
  235.    D:\PCB\PCBOARD.SYS              ;PCBoard.sys de cette node
  236.    2F8                             ;Adresse (HEX) du port de communication
  237.    9600                            ;Vitesse minimum acceptée
  238.    10                              ;Nombre de nodes accessibles aux usagers
  239.    D:\PCB\MAIN\USERNET.XXX         ;Fichier de l'état des nodes
  240.    D:\PCB\TXT\EXPLIQUE.TXT         ;Explications en cas de rejet
  241.    D:\PCB\LUCKYS.DAT               ;Liste des usagers 'sélect' ou chanceux
  242.    3                               ;IRQ du port de communication
  243.    2                               ;Minimum de nodes libres afin de couper
  244.    D:\PCB\NSC-1.LOG                ;Fichier d'usage
  245.    6 7,8                           ;Numéro des nodes qui sont vérifiées par
  246.    9                               ;Node Speed Checker (6,7,8 et 9). Un
  247.                    ;espace est traité comme une virgule.
  248.  
  249.  
  250.    Signification de chaque ligne du fichier de configuration
  251.    ─────────────────────────────────────────────────────────
  252.  
  253.    LIGNE 1
  254.    ───────
  255.  
  256.    Cette  ligne  contient  le  nom  du babillard sous lequel cette
  257.    application fonctionnera. Ce nom apparait à l'usager et à votre
  258.    écran  seulement  lorsque  l'application  est  enregistrée.
  259.    (Ex: Nom du BBS)
  260.  
  261.  
  262.    LIGNE 2
  263.    ───────
  264.  
  265.    Cette ligne contient votre numéro d'enregistrement selon le nom
  266.    de  votre  babillard.
  267.  
  268.    * Ce numéro DOIT être de valeur 0 si la DOOR n'est pas enregistrée,
  269.      sinon  la  DOOR  termine  et  ne  fonctionne  pas.
  270.  
  271.    Si cette application n'est pas enregistrée, le programme en fera mention
  272.    à votre écran  et à celui de l'usager, de plus, un delais de 20 secondes
  273.    accompagné  de  bips sonore  sera  entendu  par  vous  et l'usager avant
  274.    d'envoyé  l'état  des  nodes (WHO).
  275.  
  276.    Lorsque  cette  application  est  enregistrée, le  programme  en  fera
  277.    mention à votre écran et à celui de l'usager, le delais de 20 secondes
  278.    ainsi  que  les  bips  sonore  disparaîtront.
  279.  
  280.    Si vous désirez enregistrer  ce  programme, faites imprimer le fichier
  281.    REGISTER.FRM,  remplissez-le  et  poster  votre  demande. Le  coût  de
  282.    l'enregistrement  est  de  $15.00 CAN.
  283.    Veuillez  ne  pas  divulgué  votre  numéro  à  qui que ce soit et sous
  284.    quelque prétexte  que  ce soit. Ce numéro est strictement confidentiel
  285.    et  par  conséquent  doit  demeuré  connu  de  vous  seul.
  286.    (Ex: 0)
  287.  
  288.  
  289.                                      Page 5
  290.    NODE SPEED CHECKER v1.23                      Page 6
  291.  
  292.  
  293.  
  294.    LIGNE 3
  295.    ───────
  296.  
  297.    Cette  ligne  contient  le  numéro  de  la  node  qui  est  vérifiée.
  298.    Le  numéro  de  cette node doit correspondre  à  celui fourni  par le
  299.    fichier  inscrit  à  la  ligne 4 (PCBoard.sys),  sinon  l'application
  300.    retourne  au  BBS  immédiatement.
  301.    (Ex: 1)
  302.  
  303.  
  304.    LIGNE 4
  305.    ───────
  306.  
  307.    Cette ligne contient  le  nom COMPLET du répertoire et du nom de fichier
  308.    à être vérifié. Ce fichier se nomme généralement PCBOARD.SYS et contient
  309.    des  informations  vitales  au  bon  fonctionnement  de  l'application.
  310.    (Ex: D:\PCB\PCBOARD.SYS)
  311.  
  312.  
  313.    LIGNE 5
  314.    ───────
  315.  
  316.    Cette ligne contient l'adresse (HEXadécimale) du port de communication
  317.    de  la  node vérifiée. Exemple, si le port de communication est COM2:,
  318.    l'adresse  du  port  est 2F8. Une adresse non-standard  est supportée.
  319.    (Ex: 2F8)
  320.  
  321.  
  322.    LIGNE 6
  323.    ───────
  324.  
  325.    Cette ligne contient un code de valeur numérique compris entre 1200 et
  326.    57600.
  327.  
  328.    Comme  vous  l'avez deviné, ce chiffre représente  la vitesse minimale
  329.    d'accès  au  babillard. (Ex: 2400)
  330.  
  331.    L'ajout  de  la lettre 'E' à coté de la vitesse, signifie que seul les
  332.    modems  de  vitesse égale ou supérieure (à 2400 dans notre exemple) ET
  333.    pouvant  corrigé  les  erreurs  (LAPM, MNP etc...)  seront  acceptés.
  334.  
  335.  
  336.    NB:    La vitesse vérifiée  est  celle qui est affichée  à l'usager lors
  337.     de la connection ─────────────────┐
  338.                                           │
  339.     EXEMPLE:                    │
  340.     CONNECT 14400/ARQ/HST/HST/V.42Bis │
  341.                 ^^^^^─┐                   │
  342.     CONNECT 19200 │                   │
  343.               │                   │
  344.               │                      │
  345.               └───────────────────┘
  346.     Dans cet exemple, 14400 sera la vitesse vérifiée.
  347.  
  348.     Inutile de vous dire que les modems de 4800 bauds et plus offrent
  349.     tous  un  protocole  de  correction d'erreurs, donc pas besoin de
  350.         spécifier  la  lettre 'E'  à  coté  d'une vitesse  de  4800+ bps,
  351.         quoique  'E'  est  tout  de  même  supportée  pour  4800+  bps.
  352.    (Ex: 9600)
  353.  
  354.  
  355.                                      Page 6
  356.    NODE SPEED CHECKER v1.23                      Page 7
  357.  
  358.  
  359.  
  360.    LIGNE 7
  361.    ───────
  362.  
  363.    Cette ligne contient le nombre de nodes accessibles à tout les usagers.
  364.    (Ex: 10)
  365.  
  366.  
  367.    LIGNE 8
  368.    ───────
  369.  
  370.    Cette ligne contient le nom COMPLET du répertoire et du nom de fichier
  371.    à être vérifié par la fonction 'WHO' du programme. Ce fichier se nomme
  372.    normalement USERNET.XXX  et  contient  le  nom et la ville de ceux qui
  373.    sont connectés sur le babillard ainsi que l'activitée qu'ils effectuent.
  374.  
  375.    C'est  à  partir  de ce fichier que l'application sait si une node est
  376.    libre  ou  pas.
  377.    NSC-F.EXE crée  le  fichier NSC-CHK.XXX, ne  pas  effacer  ce  fichier
  378.    lorsqu'une  node  ou  plus  vérifiée  par  NSC-F.EXE  fonctionne!
  379.    (Ex: D:\PCB\MAIN\USERNET.XXX)
  380.  
  381.  
  382.    LIGNE 9
  383.    ───────
  384.  
  385.    Cette ligne contient  le  nom COMPLET du répertoire et du nom de fichier
  386.    à être envoyé à l'usager si le test de vérification de la vitesse de son
  387.    modem  échoue (selon  le  critère  de  sélection  de  la  ligne  6).
  388.    (Ex: D:\PCB\TXT\EXPLIQUE.TXT)
  389.  
  390.  
  391.    LIGNE 10
  392.    ────────
  393.  
  394.    Cette ligne contient le nom COMPLET du répertoire  et  du nom de fichier
  395.    texte  contenant  la  liste des usagers qui n'ont pas  à  être vérifier.
  396.  
  397.    Si  par  exemple vous spécifiez  une vitesse minimum d'accès extrêmement
  398.    élevée  disons  57600,  seulement  les  usagers  du  fichier  LUCKYS.DAT
  399.    pourront  avoir  accès  à  cette  node!
  400.    (Ex: D:\PCB\LUCKYS.DAT)
  401.  
  402.  
  403.    LIGNE 11
  404.    ────────
  405.  
  406.    Cette ligne contient la valeur du IRQ du port de communication utilisé.
  407.    Les  IRQ's  non-standard  sont  acceptés.
  408.    (Ex: 3)
  409.  
  410.  
  411.    LIGNE 12
  412.    ────────
  413.  
  414.    Cette ligne contient le nombre minimum de nodes qui doîvent être libre
  415.    afin  de  couper la  communication si la vitesse de l'usager n'est pas
  416.    acceptée.
  417.    (Ex: 2)
  418.  
  419.                                      Page 7
  420.    NODE SPEED CHECKER v1.23                      Page 8
  421.  
  422.  
  423.  
  424.    LIGNE 13
  425.    ────────
  426.  
  427.    Cette ligne contient  le  nom COMPLET  du  répertoire  et  du  nom de
  428.    fichier d'usage de l'application. Contient des informations concernant
  429.    les  vérifications  d'effectuées.
  430.    (Ex: D:\PCB\NSC-1.LOG)
  431.  
  432.  
  433.    LIGNE 14 et plus
  434.    ────────────────
  435.  
  436.    Ces  lignes  représentent le numéro des nodes  qui sont vérifiées par
  437.    Node Speed Checker. 
  438.    (Ex: 6 7,8
  439.         9)
  440.  
  441.  
  442.    * NSC-F.EXE  a  été programmé en QuickBASIC (C) Microsoft Corporation,
  443.      et compressé avec PKLITE (tm) V1.15 pour libérer de l'espace disque.
  444.  
  445.  
  446.  
  447.     ┌────────────────────────────[ NOTE ]────────────────────────────────┐
  448.     │  Le numéro d'enregistrement de Node Speed Checker est valide pour  │
  449.     │      toutes les versions passées et futures du même programme.     │
  450.     │ Ceux qui ont déjà enregistré la version 1.10 garde le même numéro. │
  451.     └────────────────────────────────────────────────────────────────────┘
  452.  
  453.  
  454.  
  455.                                 COPYRIGHTS
  456.                                 ──────────
  457.  
  458.    Node Speed Checker v1.23 Copyright (C) Avril 1993 par Claude Champagne
  459.    QBSERIAL 3.00 Copyright (C) 1992 by Jeff Sumberg, All Rights Reserved
  460.    PKLITE (tm) V1.15 Copyright 1990-1992 PKWARE Inc. All Rights Reserved.
  461.  
  462.  
  463.    --------------------------- Fin du fichier. ----------------------------
  464.